home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 003 / phone.arc / PHONE.DOC < prev    next >
Encoding:
Text File  |  1988-08-18  |  3.3 KB  |  95 lines
  1.  
  2.  
  3.         Phone   Phone Book Search
  4.  
  5.  
  6.         1.0  Phone Book Search             _____ ____ ______
  7.  
  8.  
  9.  
  10.                                    *********
  11.                                    * phone *
  12.                                    *********
  13.  
  14.  
  15.  
  16.         NAME:   phone -- Phone Book Search
  17.  
  18.         SYNOPSIS:
  19.  
  20.                 phone [-f file] arg[s]
  21.  
  22.         DESCRIPTION:
  23.  
  24.                 Phone searches a user-defined phone book  file  for  any
  25.                 entry  that  matches  any argument in the argument list.
  26.                 The phone book, normally stored in file  phone.txt,  may
  27.                 be created by any standard editor.  It contains lines of
  28.                 text, such as:
  29.  
  30.                   Digital Equipment     DEC     (617) 897-5111
  31.  
  32.                 Note that phone does not impose any format on the  text,
  33.                 only  that  the  text  consist  of  words,  separated by
  34.                 blanks.  If a line  starts  with  whitespace  (blank  or
  35.                 tab),  it  is  considered  to  be  a continuation of the
  36.                 previous line:
  37.  
  38.                   Digital Equipment     DEC     (617) 897-5111
  39.                     146 Main Street, Maynard, MA 01754
  40.  
  41.                 The example line would be printed by, e.g.,
  42.  
  43.                     phone dig
  44.  
  45.                 Searches skip over  continuation  lines.   In  a  search
  46.                 argument, two "wild-cards" are recognized:
  47.  
  48.                   * matches any string of characters, even null.
  49.  
  50.                   ?  matches a single non-null character.
  51.  
  52.                 Note that "phone *" will print the  entire  phone  book.
  53.                 Each  match  argument  will  be implicitly terminated by
  54.                 '*'.   Thus,  a  search  argument  of  "ma"  will  match
  55.                 "Martin".    Upper-   and   lower-case  are  ignored  in
  56.                 comparisons.
  57.  
  58.                 If no wild-card characters are present in an argument, a
  59.  
  60.                                                                   Page 2
  61.         Phone   Phone Book Search
  62.  
  63.  
  64.                 "Soundex" match will be used.  This permits matches even
  65.                 if you have (slightly) misspelled the name for which you
  66.                 are searching.
  67.  
  68.                 If phone is invoked without an argument, it will  prompt
  69.                 for  arguments, outputting all matches.  If the standard
  70.                 input is redirected and no argument is given, phone  may
  71.                 be used as a filter.
  72.  
  73.                 If a "-f filename" argument  is  given  on  the  command
  74.                 line,  phone searches the indicated file.  Otherwise, it
  75.                 tries to locate a phone book file  using  the  following
  76.                 search list:
  77.  
  78.                   phone.txt
  79.                   \etc\phone.txt
  80.                   e:\etc\phone.txt
  81.  
  82.         ACKNOWLEDGEMENTS:
  83.  
  84.                 The Soundex algorithm was invented by Margaret K.  Odell
  85.                 and  Robert  C.   Russell.  U.S.  patents 1261167 (1918)
  86.                 and 1435663 (1922).  The version used here was  modified
  87.                 from   one   described  in  Donald  Knuth,  Sorting  and
  88.                 Searching.
  89.  
  90.         AUTHORS:
  91.  
  92.                 Martin Minow
  93.                 J. Anthony Movshon (MSDOS conversion)
  94.  
  95.